Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Locating a Movie's Tracks and Media Structures

GetMovieTrack

The GetMovieTrack function allows your application to determine the track identifier of a track given the track's ID value.

pascal Track GetMovieTrack (Movie theMovie, long trackID);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

trackID

Specifies the ID value of the track for this operation.

DESCRIPTION

The GetMovieTrack function returns the track identifier that is appropriate to the specified track. If the function cannot locate the track, it sets this returned value to nil.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
trackIDNotFound	-2029	Cannot locate a track with this ID value

SEE ALSO

You can obtain a track's ID value by calling the GetTrackID function, which is described in the next section. You can use a track's index value to obtain its track identifier by calling the GetMovieIndTrack function, which is described in the previous section.